home *** CD-ROM | disk | FTP | other *** search
/ User's Choice Windows CD / User's Choice Windows CD (CMS Software)(1993).iso / misc1 / fc_11f.zip / README.TXT < prev    next >
Text File  |  1992-07-29  |  20KB  |  420 lines
  1.  
  2.    WELCOME TO FILE COMMANDER!
  3.  
  4.    This disk contains File Commander 1.1F
  5.  
  6.    File Commander is an extender for the Win 3.1 File Manager.  It allows
  7.    you to add four (see below) menu items to the File Manager menu bar.
  8.    From each of these top-level menu items, File Commander allows you to
  9.    make up to 99 menu items spread up to 5 levels deep.
  10.  
  11.    There are few things you should understand about the File Manager and
  12.    its relationship to File Commander and other File Manager extenders.
  13.    Be sure to read the both the general information and the installation
  14.    notes section below.
  15.  
  16.  
  17.  
  18.    ***   SPECIAL OFFER FOR COMMAND POST USERS   ***
  19.  
  20.    People who have licensed Command Post from us in the past may
  21.    license File Commander for $35.
  22.  
  23.  
  24.  
  25.    *** LATE BREAKING NEWS ***
  26.  
  27.    File Commander 1.1 allows you to add upto 4 top-level menus to the
  28.    Windows File Manager menu.  Previous versions only allowed one top-level
  29.    menu.  Each top-level menu can support upto 99 menu items, spread across
  30.    4 levels of drop-downs.  I know this is a tad confusing - the best bet is
  31.    to install File Commander, run File Manager and poke around at the new
  32.    menu items.   Once you see what our sample menu scripts can do for you,
  33.    you will want to write your own menu scripts to add your own menu items
  34.    to the menus.
  35.  
  36.    We're still working on the printed documentation.  The documentation that
  37.    accompanies the product is all we have right now.  All registered users
  38.    will receive a copy of the printed documentation when it becomes available.
  39.    (Best guesses are Mid-Sept 1992).
  40.  
  41.    File Commander comes with four sample menu files, each of which are
  42.    associated with a new File Manager menu item.  To wit:
  43.  
  44.        Menu title          Menu File
  45.  
  46.        Main                WWWFC1.MNU
  47.        Applets             WWWFC2.MNU
  48.        Utils               WWWFC3.MNU
  49.        Demo                WWWFC4.MNU
  50.  
  51.    Although these files are mainly intended as code samples that you can
  52.    peruse to make your own add-on menu items, a lot of people, especially
  53.    those not willing to plunge in and learn the batch language, will find
  54.    that the sample menu items do all sorts of neat stuff, and may be
  55.    perfectly content to live with the sample menus supplied.
  56.  
  57.    These sample menus are not exactly documented anyplace, but if you
  58.    browse through the pull-down menus in File Manager, the functions of
  59.    the various menus items should become obvious.  We've carefully designed
  60.    them to run on almost *any* system.  If something does not work for you,
  61.    then its up to you to dig into the sample menu code and rectify any
  62.    imcompatibilities that may be occurring.
  63.  
  64.  
  65.    *** NORTON DESKTOP FOR WINDOWS ***
  66.  
  67.    This new version also allows you to add the same menu items to the
  68.    Norton Desktop for Windows File Manager menu.  File Commander will
  69.    attempt to determine if there are any compatibility problems, and,
  70.    if so, will put up a message with further instructions, and then
  71.    exit.
  72.  
  73.    In some cases, especially with Non-English versions of NDW, there may
  74.    be serious undetectable incompatibility problems.
  75.  
  76.    To turn off the informational message OR to tell File Commander NOT
  77.    to run with the NDW File Manager, do the following:
  78.  
  79.        Edit the WINFILE.INI file  ((( NOT WIN.INI !!! )))
  80.        Find the [FileCmdr] Section.  If it does not exist, make one.
  81.        Insert a line containing "NDW=2"
  82.        When you are done it should look something like...
  83.  
  84.                [FileCmdr]
  85.                NDW=2
  86.  
  87.  
  88.    If you experience problems when starting the Norton Desktop (Version 2.0)
  89.    File Manager with File Commander, please contact Symantec's Peter Norton
  90.    Group technical support at (310) 449-4900 for assistance.  Be sure to
  91.    mention "File Commander" clearly, and they will be able take care of you.
  92.  
  93.    If you add the NDW=2 line to your WINFILE.INI file because of compatibility
  94.    problems, be sure to remove the line when you wish to test to see if the
  95.    compatibility problems got resolved.
  96.  
  97.  
  98.  
  99.    *** GENERAL INFORMATION ***
  100.  
  101.    File Commander is an extender for the Win 3.1 File Manager.  It allows
  102.    you to add upto four menu items to the File Manager menu bar.
  103.  
  104.    From each of these top-level menu items, File Commander allows you to
  105.    make up to 99 menu items spread up to 5 levels deep.
  106.  
  107.    The menu items, when selected, execute our Windows Interface Language (WIL)
  108.    code.  What is the WIL language?  Well, its the Windows batch file language
  109.    developed by Wilson WindowWare, and found in several products, including
  110.    the following:
  111.  
  112.      Wilson WindowWare: Command Post     - As the menu script language
  113.      Wilson WindowWare: WinBatch         - The Windows batch language
  114.      Symantec:          Norton Desktop   - The Batch Runner/Builder language 
  115.  
  116.      >>> If you have used Command Post, you will find the menu scripts
  117.      >>> *remarkably* similiar. 
  118.  
  119.    The WIL language supports zillions (well maybe 200) different functions
  120.    that allow you to do pritnear anything.
  121.  
  122.    Be sure to check out our new WIL.HLP Windows help file.  It has a
  123.    (pretty much - we're working on it) complete description of the WIL
  124.    language (Thats the programming language found in our products).  It
  125.    should prove useful.
  126.  
  127.    NOTE:  The documentation for the Windows File Manager Extender Interface
  128.    states that 5 top-level menus may be added to the File Manager menu.
  129.    However, due to what appears to be a bug, the fifth menu item does not
  130.    work properly.  Any command selected from the fifth menu item becomes
  131.    confused with the adjacent "Windows" menu, and the corresponding command
  132.    from the "Windows" menu is executed instead.  All this is saying is don't
  133.    use more than 4 new top-level menus with the Windows File Manager.
  134.  
  135.    Norton Desktop for Windows File Manager does support up to
  136.    10 total addon menus.
  137.  
  138.  
  139.    INSTALLATION NOTES
  140.  
  141.    File Manager Extenders are not EXE files.  They are DLL's.  When File
  142.    Manager (either Windows or Norton) starts up, it inspects the WINFILE.INI
  143.    (Note: NOT WIN.INI) file for a special [AddOns] section.  The [AddOns]
  144.    section (when File Commander is installed) looks like the following:
  145.  
  146.          [AddOns]
  147.          WWWFC1=WWWFC1.DLL
  148.          WWWFC2=WWWFC2.DLL
  149.          WWWFC3=WWWFC3.DLL
  150.          WWWFC4=WWWFC3.DLL
  151.  
  152.    If you are running the Windows File Manager, you should only have 4 items
  153.    in the [Addons] section (due to the aforementioned bug).  If you run NDW,
  154.    you can have 5, but if you run the Windows File Manager from NDW, remember
  155.    that the 5th added menu item is broken.
  156.  
  157.    The File Commander install process installs 4 DLL's to allow you to have
  158.    4 menu items.  There are a few other *much less capable* extenders
  159.    available from various sources.  Some of these are:
  160.  
  161.           a) The NDW extender.
  162.           b) The Windows Resource toolkit File Size extender.
  163.           c) An extender known as "Goodies"
  164.           d) Certain internal corporate extenders
  165.           e) And others likely to show up someplace or another.
  166.  
  167.    In any case, if you have another extender, you may have to pick and choose
  168.    the extenders that you keep.  In general, File Commander, with just a few
  169.    new menu scripts, can do *anything* and *everything* that any other
  170.    extender imaginable could possibly hope to do.  The only real reason to
  171.    keep any of the other extenders around is if your corporate MIS department
  172.    informs you that if you don't, you might get fired.
  173.  
  174.    So....the upkeep and maintenance of the [AddOns] section of the WINFILE.INI
  175.    is your responsibility.  You will have to decide what to keep and what goes.
  176.  
  177.    We do provide four extenders:
  178.  
  179.        WWWFC1.DLL
  180.        WWWFC2.DLL
  181.        WWWFC3.DLL
  182.        WWWFC4.DLL
  183.  
  184.    which our installation program will install.  Each one controls a menu
  185.    item.  The menu items will appear on your File Manager menu in the same
  186.    order that the menu items occur in the [AddOns] section.
  187.  
  188.    The installation process installs, and File Commander refers to an
  189.    additional, new section of the WINFILE.INI file -- The [FileCmdr] section.
  190.  
  191.    The [FileCmdr] section of the WINFILE.INI file contains the titles of the
  192.    top level menu items, and also contains the file names of the menu script
  193.    files.  You usually do not have to worry about these items, as our sample
  194.    menu scripts maintain this section.  However, in the interest of complete
  195.    documentation, the [FileCmdr] section as it appears immediately after File
  196.    Commander installation is shown below:
  197.  
  198.  
  199.        [FileCmdr]
  200.        MenuFile1=WWWFC1.MNU
  201.        MenuFile2=WWWFC2.MNU
  202.        MenuFile3=WWWFC3.MNU
  203.        MenuFile4=WWWFC4.MNU
  204.        MenuTitle1=&Main
  205.        MenuTitle2=&Applets
  206.        MenuTitle3=&Utils
  207.        MenuTitle4=&Demos
  208.  
  209.   The WWWFC1.DLL extender will refer to the MenuFile1 keyword to determine
  210.   which menu script file to use, and it will refer to the MenuTitle1 keyword
  211.   to determine the title of the desired menu item.
  212.  
  213.   Likewise, the WWWFC2.DLL extender will refer to MenuFile2 and MenuTitle2,
  214.   and so on.
  215.  
  216.  
  217.  
  218.    HOW-2-ADD YOUR OWN MENU ITEMS
  219.  
  220.    The Main menu item added to the File Manager menu has a selection to
  221.    assist you in editing menus.  All it really does is to run the Windows
  222.    Notepad editor on one of the four menu files, WWWFC1.MNU, WWWFC2.MNU,
  223.    WWWFC3.MNU or WWWFC4.MNU.
  224.  
  225.    In order to take full advantage of File Commander, you should read
  226.    through most of the documentation.  It will teach you about the WIL
  227.    script language in an easy step-by-step fashion (We've got stacks of
  228.    letters from non-programmers who said they were a tad scared about
  229.    tackling the WIL language, but once they went through our tutorial,
  230.    can write menu scrips with the best of them.  One guy even decided he
  231.    liked programming, took a few community college courses, and now has
  232.    a job programming for a living!)
  233.  
  234.    More experienced people, people who are familiar with DOS BAT files,
  235.    people familiar with DOS BASIC or other programming languages, and
  236.    the average unreconstructed hackers may simply wish to plunge in,
  237.    examine the sample menus and wing it.  Although we don't officially
  238.    reccommend this kind of thing, it does happen.
  239.  
  240.    In any case, especially for those trying to "wing it", the menu script
  241.    files ares COLUMN SENSITIVE, especially in the first four columns
  242.    (character positions) which define the menu item titles.  WIL batch code
  243.    should start in column 5 or later (I like col 8).  The structure of a
  244.    menu file (this is the short form, see the docs for a real explanation);
  245.  
  246.                          111111111122222222223
  247.      Columns    123456789012345678901234567890... etc
  248.                 ; Semicolons are the comment symbol.  Everything to the
  249.                 ; right of a semi-colon is ignored.  At the top of the file
  250.                 ; is the "auto-exec" section which runs on File Manager
  251.                 ; startup, and whenever the extenders are reloaded.
  252.                 ; Note that the autoexec code starts in column 8 (way past
  253.                 ; column 5 so it does not get confused with menu items.
  254.                         TAB=Num2Char(9)        ; Define a TAB char for laters
  255.                         CR=strcat(Num2Char(13),Num2Char(10)) ; Define a CRLF
  256.                 ; That was our autoexec section.  It just defined a few
  257.                 ; special characters for later use.  Here is our first menu
  258.                 ; item...
  259.                 NOTEPAD
  260.                         Run("Notepad.exe","")      ;Run Notepad
  261.                 ; That was it.  The word NOTEPAD will appear on a menu and
  262.                 ; when selected it will execute the command that launches the
  263.                 ; Notepad editor.
  264.                 ; Now, lets have a drop-down menu that off of a menu item.
  265.                 ; (Menu items don't need to be all CAPS, it is just to make
  266.                 ; this example a tad clearer.
  267.                 ACCESSORIES
  268.                  CONTROL PANEL
  269.                         Run("Control.exe","")
  270.                  CALCULATOR
  271.                         Run("Calc.exe","")
  272.                 ; Note that the first level menu, ACCESSORIES started in
  273.                 ; column 1, and that the two drop down menu items off of it
  274.                 ; both started in column 2.  It is important to remember that
  275.                 ; the columns that the menu titles start in control what kind
  276.                 ; of menu item it is, and putting a menu item in the wrong
  277.                 ; column is the most common error in writing a menu.
  278.  
  279.  
  280.    When loading a new menu script, File Commander will report on lines in the
  281.    menu script file that it does not like.  In general it is always expecting
  282.    one kind of line or another, and if the current line does not meet up to
  283.    its expectations, it displays the line with an error message.  Quite often,
  284.    the actual error occurred on the previous line.  Almost all problems on
  285.    load have to do with improper indent in the menu titles.  In addition,
  286.    after an error, the remainder of the menu file is ignored.
  287.  
  288.    Each menu script file can only support upto 99 menu items.  It you have
  289.    more that 99 menu items, the ones past the 99th item will not appear, and,
  290.    if the 100th item occurs on some sub-level menu, can make its parent level
  291.    disappear too.
  292.  
  293.    THE WIL.HLP file
  294.  
  295.    The installation program should have installed an icon in the Program
  296.    Manager File Commander group which will bring up this file.  Or just
  297.    double click on it to make it run.  Its also accessable from our sample
  298.    menus.
  299.  
  300.    The first menu item you write might be to add a new menu item to access
  301.    the WIL.HLP file to one of your own menus.  Here's one way to do it.
  302.  
  303.        First, figure out where the WIL.HLP file is.  Lets assume that you
  304.        took the standard installation program defaults.  That would put
  305.        the WIL.HLP file into the C:\FILECMDR\HELP directory.  Verify this.
  306.  
  307.        Assuming you have File Commander running, select the "Main" menu item.
  308.        The first thing you will see in the drop-down menu that appears is the
  309.        "Edit File Commander Menus".  Select that option.
  310.  
  311.        Another drop down menu will appear which gives you a choice of editing
  312.        the menu scripts or changing the top-level menu titles.  Choose the
  313.        first selection, "Edit menu scripts".
  314.  
  315.        This will pop you into the Notepad editor, editing the WWWFC1.MNU
  316.        menu file.  Move to the bottom of the file and add the following
  317.        lines.  BE SURE THAT THE MENU TITLE STARTS AT THE FAR LEFT WITH NO
  318.        SPACES IN FRONT OF IT.  Adjust the DirChange command, if required,
  319.        to point to the directory containing the WIL.HLP file.
  320.  
  321.               ; This menu item brings up the WIL.HLP help file
  322.               Get WIL Help File
  323.                       DirChange("C:\FILECMDR\HELP")
  324.                       Run("winhelp.exe","wil.hlp")
  325.  
  326.        Close the note pad editor.  Look at your first menu.  Strange, the
  327.        new menu item is NOT there.  Select one of the menu items, say 
  328.        "Browse".  File Commander will look at the file, decide that it was
  329.        modified since the last time it was inspected, and proceed to reload
  330.        the file.  Since there's no telling what might have changed in the
  331.        file, File Commander will tell you that the menu files were reloaded,
  332.        and that you should re-select the desired menu item.
  333.  
  334.        After a short delay while the reload occurs, look at the menu item 
  335.        again.  Lo and behold, it should be there on the bottom of the first
  336.        menu.  Select it.  WinHelp should load with the WIL language help.
  337.  
  338.        Good Luck.
  339.  
  340.  
  341.  
  342.    The WIL.HLP file was produced and designed by Jim Stiles.  If you need
  343.    or want professional consulting for custom help systems,
  344.    ask for Jim at (206) 937-3141.
  345.  
  346.  
  347.   *** FOREIGN LANGUAGE SUPPORT ***
  348.  
  349.   File Commander now supports some foreign languages.  English is built in,
  350.   and the software attempts to examine your system, and, if you are using
  351.   German or French, will configure itself to use German or French.  More
  352.   languages on the way.  There is also "ValSpeak", which is both a parody
  353.   on Southern California slang, and an example of how *some* messages may
  354.   be modified for the end users.
  355.  
  356.   If you are using Windows 3.1, File Commander will attempt to determine
  357.   what language Windows you are running and automatically configure itself
  358.   to use that language.
  359.  
  360.   To access a non-default langauage do the following:
  361.  
  362.       1) Examine the WWWDLANG.DLL file to determine the languages
  363.          available.  The file has documentation in it that will help you
  364.          figure this out.  (It is not really a DLL, you can look at it.
  365.          It will probably be in your Windows directory.)
  366.     
  367.       2) Edit the WWWBATCH.INI file and add an item to the MAIN section,
  368.          something like:
  369.  
  370.          WWWBATCH.INI
  371.             [Main]
  372.             Language=ValSpeak
  373.  
  374.   Restart Windows, and, walla, the new language should appear.
  375.  
  376.                        PACKING LIST:
  377.  
  378.  With this version you have the following files:   You will find that
  379.  on your disk or ZIP file, many of the files end in a $.  This is to be
  380.  expected.  Some files may have been compressed and will need to properly
  381.  installed to be useful, while other files may be simply copied and renamed.
  382.  
  383.  README   TXT  Latest news and comments about File Commander  (this file)
  384.  README2  TXT  Readme.txt  ...continued...
  385.  FILECMDR MAN  The documentation for File Commander
  386.  WININFO  EXE  A handy utilty to help write the "WinPlace" statement
  387.  FC__VER  ???  Version number file.  The extension shows the version number
  388.  FILE_ID  DIZ  A standard description file to help BBS sysops
  389.  
  390.  WWWFC1   DLL  The DLL for the first  extender menu item
  391.  WWWFC2   DLL  The DLL for the second extender menu item
  392.  WWWFC3   DLL  The DLL for the third  extender menu item
  393.  WWWFC4   DLL  The DLL for the fourth extender menu item
  394.  
  395.  WWWFC1   MNU  The Menu file for the first  extender menu item
  396.  WWWFC2   MNU  The Menu file for the second extender menu item
  397.  WWWFC3   MNU  The Menu file for the third  extender menu item
  398.  WWWFC4   MNU  The Menu file for the fourth extender menu item
  399.  
  400.  WWWFMEAA DLL  The Main File Commander DLL
  401.  WWWBATxx DLL  The WIL script processor DLL (where xx is a number)
  402.  WWWDLANG DLL  Foreign Language support for the WIL script processor DLL
  403.  WWWDEALR DLL  Yet another required DLL
  404.  WWWZIP   DLL  ZIP file processing scripts
  405.  WWWVIRT  BAT  Sample BAT file that changes PATH for DOS apps
  406.  WWWDOS   BAT  DOS BAT file used in some of our menu scripts
  407.  WWWDOSC  PIF  PIF that calls WWWDOS.BAT and pauses
  408.  WWWDOSP  PIF  PIF that calls WWWDOS.BAT and then closes the window
  409.  WWWZIPLS EXE  Zip processor EXE file
  410.  
  411.  WSETUP   INF  A script file for the setup program
  412.  WSETUP   EXE  The snazzy setup program
  413.  WBINXZ   EXE  More of our setup program.
  414.  BROWSER  EXE  A handy file browser utility
  415.  BROWLANG DLL  International language support for Browser
  416.  WIL      HLP  The Windows help file for our language
  417.  
  418.  
  419.    Please see the README2.TXT file for more information
  420.